home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / vpixdemo.zip / VIEWPIX.DOC < prev    next >
Text File  |  1992-02-13  |  9KB  |  176 lines

  1.  
  2.  
  3.                    VIEWPIX - Online GIF File Viewing Door
  4.                 Copyright (C) 1991 No Anchovies - Frank Capo
  5.                             All Rights Reserved
  6.  
  7.  
  8.     --------
  9.     Overview
  10.     --------
  11.         VIEWPIX is a BBS door designed to allow your users to preview GIF
  12.     graphics online.  VIEWPIX works in conjuction with GIFDesk - a freeware
  13.     utility written by Jay Wherley, and SHOWGIF - a shareware utility written
  14.     by Bill Parquet.  Both GIFDesk and SHOWGIF are excellent programs in their
  15.     own right and you are urged to spread the word about them.
  16.  
  17.  
  18.     ------------
  19.     Installation
  20.     ------------
  21.         Included in the VIEWPIX package are VIEWPIX.EXE, GIFDSK40.ZIP,
  22.     SHGIF55C.ZIP, SAMPLE.LST, SAMPLE.DIR, SAMPLE.CNF, and VIEWPIXG.  Put the
  23.     SHGIF55C.ZIP aside for now - unpack all the rest to a subdirectory on your
  24.     BBS drive.  Multi-node systems must do the same for each node.
  25.  
  26.         Edit SAMPLE.CNF to conform to the following:
  27.  
  28.     c:\gap                  <- Drive\path to DOOR.SYS (or other "door" file)
  29.     No Anchovies PC         <- The name of your BBS
  30.     GAP                     <- Type of BBS software (see Note below)
  31.     0000                    <- Serial Number (for registered version)
  32.     c:\viewpix\sample.lst   <- Fully qualified drive\path\filename (see below)
  33.     c:\viewpix\sample.dir   <- Fully qualified drive\path\filename (see below)
  34.     F:                      <- Drive spec for work Directory (or NONE)
  35.     7                       <- Default VIEWPIX configuration (see below)
  36.     456789                  <- Allowable configuration options (see below)
  37.  
  38.     Note : Line #3 above can be set to the following BBS software types:
  39.         
  40.                     GAP  - GAP BBS  (uses DOOR.SYS)
  41.                     PCB  - PCBoard  (uses DOOR.SYS ONLY!)
  42.                        WC3  - Wildcat! v3.x  (uses DOOR.SYS)
  43.                     WWIV - WWIV  (uses CHAIN.TXT)
  44.                     SF   - Spitfire  (uses SFDOORS.DAT)
  45.                     RBBS - RBBS  (uses DORINFOn.DEF)
  46.  
  47.     Note : Lines #5 & #6 above reference two files that are vital to VIEWPIX
  48.            operation. These lines MUST be fully qualified drive\path\filenames.
  49.            Let's examine the contents of these two files.
  50.  
  51.     Note : Lines #8 & #9 refer to the type of graphic that GIFDesk will
  52.            compose.  Here's a rundown:
  53.  
  54.                 #      Grid             Resolution
  55.                 ---------------------------------------
  56.                 1 -> 1 x 1 Grid      640x480 resolution
  57.                 2 -> 1 x 1 Grid      800x600 resolution
  58.                 3 -> 1 x 1 Grid     1024x768 resolution
  59.                 4 -> 2 x 2 Grid      640x480     " "
  60.                 5 -> 2 x 2 Grid      800x600     " "
  61.                 6 -> 2 x 2 Grid     1024x758     " "
  62.                 7 -> 3 x 3 Grid      640x480     " "
  63.                 8 -> 4 x 4 Grid      800x600     " "
  64.                 9 -> 5 x 5 Grid     1024x768     " "
  65.  
  66.     Line #8 is the DEFAULT setup you wish the door to start with.  Users can
  67.     change this to any of the allowable options (1-9) you place on Line #9.
  68.  
  69.         SAMPLE.LST and SAMPLE.DIR contain directory information that VIEWPIX
  70.     uses to find and display the GIF files on your system.
  71.  
  72.         SAMPLE.LST contains the drive\path specs for all directories on your
  73.     system that contain GIF files.  You can have as many specs as you need.
  74.     Just make sure you put ONE SPEC PER LINE and make sure the subdirectories
  75.     actually exist somewhere on your system.
  76.  
  77.         SAMPLE.DIR contains the "header names" of each directory in SAMPLE.LST.
  78.     If you have several directories with various types of GIF files, you can
  79.     place a descriptive name here - again, ONE PER LINE with a number in front
  80.     of it followed by a space.  SAMPLE.LST and SAMPLE.DIR must have the same
  81.     number of lines.
  82.  
  83.         Okay, we're almost there.  Now, all that remains is to create a batch
  84.     file that will run the whole thing.  BBS software differs a bit as to
  85.     where you place the BAT file.  Put it where you would for any other door.
  86.     Here's what VIEWPIX needs to execute.  We'll call it VIEWPIX.BAT.
  87.  
  88.                @echo off            <- My preference
  89.                c:\                  <- Just to be sure
  90.                cd \viewpix          <- Change to door directory
  91.                viewpix viewpix.cnf  <- Run VIEWPIX with config file parameter
  92.                c:\                  <- Just to be sure again
  93.                cd \gap              <- Back to BBS directory
  94.  
  95.         The line above that runs VIEWPIX can have any filename as a parameter.
  96.     Just make sure you have that filename (as in SAMPLE.CNF above) in the
  97.     door directory.  Likewise, the names of the ".LST" and ".DIR" files can
  98.     be anything you choose as long as you tell VIEWPIX in the config file.
  99.  
  100.         That, pretty much, does it!  The door should run now providing you've
  101.     set it up properly.
  102.  
  103.  
  104.     --------------
  105.     Door Operation
  106.     --------------
  107.         Your users are gonna love it!  How many times have you downloaded
  108.     300+ k GIF files only to find that they're really not what you expected?
  109.     That's where VIEWPIX comes to the rescue.  Here's what actually happens.
  110.  
  111.         Users can display file listings of all your GIFs and, depending on
  112.     how they choose to configure VIEWPIX, download and/or view a single
  113.     "preview" GIF file containing the pictures they've selected.  GIFDesk,
  114.     an amazing piece of software, is responsible for making up this "preview"
  115.     GIF file.  VIEWPIX passes filenames to GIFDesk and GIFDesk works it's
  116.     magic.  VIEWPIX then takes the "preview" file, gives it a unique DOS
  117.     filename, and sends it to the user.  If the user has SHOWGIF loaded as a
  118.     TSR, they'll see the graphic as it's being downloaded.  If not, they can
  119.     look at the "preview" afterwards with any GIF viewer.
  120.  
  121.         Before I forget - VIEWPIX also needs DSZ to perform file transfers.
  122.     DSZ from Omen Technologies is a fine protocol package that no sysop should
  123.     be without.  Get it and REGISTER IT!  Make sure it's in your path, too, so
  124.     VIEWPIX can find it.
  125.  
  126.         Back to the door's operation.  VIEWPIX will run locally from within
  127.     your BBS.  Logon locally, go into VIEWPIX, and have it make a preview for
  128.     you.  You won't be able to view the file online, but you will be able to
  129.     store the file in any directory you choose and view it later with your
  130.     favorite GIF viewer.  --- OR --- load up SHOWGIF and give No Anchovies BBS
  131.     a call (see numbers below).
  132.  
  133.  
  134.     -----------
  135.     SysOp Stuff
  136.     -----------
  137.         VIEWPIX is written in QuickBASIC 4.5 using Kenny Gardner's GAPQBDR door
  138.     library.  VIEWPIX has been compiled to "stand alone" and needs no fossil
  139.     driver or runtime library to execute.  As sysop, you have certain function
  140.     keys available to you while users are in VIEWPIX.
  141.  
  142.                     [F5]    <- Shell to DOS ("EXIT" brings you back)
  143.                     [F8]    <- Twit the user back to the BBS
  144.                    [F10]    <- Chat with user (ESC to end chat)
  145.                   [Home]    <- Main user stats in sysop window
  146.                    [End]    <- Displays sysop function keys
  147.                   [PgDn]    <- More user stats
  148.               [Up Arrow]    <- Increase user's remaining time
  149.               [Dn Arrow]    <- Decrease user's remaining time
  150.  
  151.          *********************************************************
  152.          *****  DO NOT ALTER THE FILE "VIEWPIXG" IN ANY WAY  *****
  153.          *****   DOING SO WILL RENDER VIEWPIX IN OPERABLE    *****
  154.          *********************************************************
  155.  
  156.  
  157.     ------------
  158.     Registration
  159.     ------------
  160.         VIEWPIX registration is $35.00 payable by check or money order to:
  161.  
  162.                               No Anchovies PC
  163.                               1205 Lake Avenue
  164.                               Ashtabula, OH.  44004
  165.  
  166.         The unregistered demo version will only allow 10 GIF files to display
  167.     in only one directory.
  168.  
  169.         When you register, you'll be given access to the VIEWPIX support forum
  170.     on No Anchovies BBS (216-466-1152 and 1153, both HST Dual Standard).  It
  171.     is here that you will receive a serial number that will register the door.
  172.  
  173.         Any questions, comments, etc. can be addressed in a comment to SYSOP
  174.     on No Anchovies.
  175.     
  176.